package com.xiuxia.bopicturebackend.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.xiuxia.bopicturebackend.model.dto.space.SpaceAddRequestDTO;
import com.xiuxia.bopicturebackend.model.dto.space.SpaceQueryRequestDTO;
import com.xiuxia.bopicturebackend.model.entity.Space;
import com.baomidou.mybatisplus.extension.service.IService;
import com.xiuxia.bopicturebackend.model.entity.User;
import com.xiuxia.bopicturebackend.model.vo.space.SpaceVO;

import javax.servlet.http.HttpServletRequest;

/**
 * @author 17732
 * @description 针对表【space(空间)】的数据库操作Service
 * @createDate 2025-06-21 14:20:18
 */
public interface SpaceService extends IService<Space> {
    /**
     * 校验空间参数
     *
     * @param space 控件对象
     * @param add   是否为创建
     */
    void validSpace(Space space, boolean add);

    /**
     * 根据空间等级填充空间参数
     *
     * @param space 空间对象
     */
    void fillSpaceBySpaceLevel(Space space);

    /**
     * 创建空间
     *
     * @param spaceAddRequestDTO 创建空间请求参数
     * @param loginUser          登录用户
     * @return 创建的空间id
     */
    Long addSpace(SpaceAddRequestDTO spaceAddRequestDTO, User loginUser);

    /**
     * 获取查询条件
     *
     * @param spaceQueryRequestDTO 查询参数
     * @return 查询条件
     */
    QueryWrapper<Space> getQueryWrapper(SpaceQueryRequestDTO spaceQueryRequestDTO);

    /**
     * 获取空间封装类
     *
     * @param space   空间对象
     * @param request 请求对象
     * @return 封装类
     */
    SpaceVO getSpaceVO(Space space, HttpServletRequest request);

    /**
     * 获取空间分页封装类
     *
     * @param spacePage 分页对象
     * @param request   请求对象
     * @return 分页封装类
     */
    Page<SpaceVO> getSpaceVOPage(Page<Space> spacePage, HttpServletRequest request);

    /**
     * 校验空间权限
     *
     * @param loginUser 登录用户
     * @param space     空间对象
     */
    void checkSpaceAuth(User loginUser, Space space);
}
